home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / lib / python2.5 / distutils / util.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-29  |  15KB  |  437 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.5)
  3.  
  4. """distutils.util
  5.  
  6. Miscellaneous utility functions -- anything that doesn't fit into
  7. one of the other *util.py modules.
  8. """
  9. __revision__ = '$Id: util.py 59116 2007-11-22 10:14:26Z ronald.oussoren $'
  10. import sys
  11. import os
  12. import string
  13. import re
  14. from distutils.errors import DistutilsPlatformError
  15. from distutils.dep_util import newer
  16. from distutils.spawn import spawn
  17. from distutils import log
  18.  
  19. def get_platform():
  20.     """Return a string that identifies the current platform.  This is used
  21.     mainly to distinguish platform-specific build directories and
  22.     platform-specific built distributions.  Typically includes the OS name
  23.     and version and the architecture (as supplied by 'os.uname()'),
  24.     although the exact information included depends on the OS; eg. for IRIX
  25.     the architecture isn't particularly important (IRIX only runs on SGI
  26.     hardware), but for Linux the kernel version isn't particularly
  27.     important.
  28.  
  29.     Examples of returned values:
  30.        linux-i586
  31.        linux-alpha (?)
  32.        solaris-2.6-sun4u
  33.        irix-5.3
  34.        irix64-6.2
  35.  
  36.     For non-POSIX platforms, currently just returns 'sys.platform'.
  37.     """
  38.     if os.name != 'posix' or not hasattr(os, 'uname'):
  39.         return sys.platform
  40.     
  41.     (osname, host, release, version, machine) = os.uname()
  42.     osname = string.lower(osname)
  43.     osname = string.replace(osname, '/', '')
  44.     machine = string.replace(machine, ' ', '_')
  45.     machine = string.replace(machine, '/', '-')
  46.     if osname[:5] == 'linux':
  47.         return '%s-%s' % (osname, machine)
  48.     elif osname[:5] == 'sunos':
  49.         if release[0] >= '5':
  50.             osname = 'solaris'
  51.             release = '%d.%s' % (int(release[0]) - 3, release[2:])
  52.         
  53.     elif osname[:4] == 'irix':
  54.         return '%s-%s' % (osname, release)
  55.     elif osname[:3] == 'aix':
  56.         return '%s-%s.%s' % (osname, version, release)
  57.     elif osname[:6] == 'cygwin':
  58.         osname = 'cygwin'
  59.         rel_re = re.compile('[\\d.]+')
  60.         m = rel_re.match(release)
  61.         if m:
  62.             release = m.group()
  63.         
  64.     elif osname[:6] == 'darwin':
  65.         get_config_vars = get_config_vars
  66.         import distutils.sysconfig
  67.         cfgvars = get_config_vars()
  68.         macver = os.environ.get('MACOSX_DEPLOYMENT_TARGET')
  69.         if not macver:
  70.             macver = cfgvars.get('MACOSX_DEPLOYMENT_TARGET')
  71.         
  72.         if not macver:
  73.             
  74.             try:
  75.                 f = open('/System/Library/CoreServices/SystemVersion.plist')
  76.             except IOError:
  77.                 pass
  78.  
  79.             m = re.search('<key>ProductUserVisibleVersion</key>\\s*' + '<string>(.*?)</string>', f.read())
  80.             f.close()
  81.             if m is not None:
  82.                 macver = '.'.join(m.group(1).split('.')[:2])
  83.             
  84.         
  85.         if macver:
  86.             get_config_vars = get_config_vars
  87.             import distutils.sysconfig
  88.             release = macver
  89.             osname = 'macosx'
  90.             if release + '.' >= '10.4.' and get_config_vars().get('UNIVERSALSDK', '').strip():
  91.                 machine = 'fat'
  92.             elif machine in ('PowerPC', 'Power_Macintosh'):
  93.                 machine = 'ppc'
  94.             
  95.         
  96.     
  97.     return '%s-%s-%s' % (osname, release, machine)
  98.  
  99.  
  100. def convert_path(pathname):
  101.     """Return 'pathname' as a name that will work on the native filesystem,
  102.     i.e. split it on '/' and put it back together again using the current
  103.     directory separator.  Needed because filenames in the setup script are
  104.     always supplied in Unix style, and have to be converted to the local
  105.     convention before we can actually use them in the filesystem.  Raises
  106.     ValueError on non-Unix-ish systems if 'pathname' either starts or
  107.     ends with a slash.
  108.     """
  109.     if os.sep == '/':
  110.         return pathname
  111.     
  112.     if not pathname:
  113.         return pathname
  114.     
  115.     if pathname[0] == '/':
  116.         raise ValueError, "path '%s' cannot be absolute" % pathname
  117.     
  118.     if pathname[-1] == '/':
  119.         raise ValueError, "path '%s' cannot end with '/'" % pathname
  120.     
  121.     paths = string.split(pathname, '/')
  122.     while '.' in paths:
  123.         paths.remove('.')
  124.     if not paths:
  125.         return os.curdir
  126.     
  127.     return apply(os.path.join, paths)
  128.  
  129.  
  130. def change_root(new_root, pathname):
  131.     '''Return \'pathname\' with \'new_root\' prepended.  If \'pathname\' is
  132.     relative, this is equivalent to "os.path.join(new_root,pathname)".
  133.     Otherwise, it requires making \'pathname\' relative and then joining the
  134.     two, which is tricky on DOS/Windows and Mac OS.
  135.     '''
  136.     if os.name == 'posix':
  137.         if not os.path.isabs(pathname):
  138.             return os.path.join(new_root, pathname)
  139.         else:
  140.             return os.path.join(new_root, pathname[1:])
  141.     elif os.name == 'nt':
  142.         (drive, path) = os.path.splitdrive(pathname)
  143.         if path[0] == '\\':
  144.             path = path[1:]
  145.         
  146.         return os.path.join(new_root, path)
  147.     elif os.name == 'os2':
  148.         (drive, path) = os.path.splitdrive(pathname)
  149.         if path[0] == os.sep:
  150.             path = path[1:]
  151.         
  152.         return os.path.join(new_root, path)
  153.     elif os.name == 'mac':
  154.         if not os.path.isabs(pathname):
  155.             return os.path.join(new_root, pathname)
  156.         else:
  157.             elements = string.split(pathname, ':', 1)
  158.             pathname = ':' + elements[1]
  159.             return os.path.join(new_root, pathname)
  160.     else:
  161.         raise DistutilsPlatformError, "nothing known about platform '%s'" % os.name
  162.  
  163. _environ_checked = 0
  164.  
  165. def check_environ():
  166.     """Ensure that 'os.environ' has all the environment variables we
  167.     guarantee that users can use in config files, command-line options,
  168.     etc.  Currently this includes:
  169.       HOME - user's home directory (Unix only)
  170.       PLAT - description of the current platform, including hardware
  171.              and OS (see 'get_platform()')
  172.     """
  173.     global _environ_checked
  174.     if _environ_checked:
  175.         return None
  176.     
  177.     if os.name == 'posix' and not os.environ.has_key('HOME'):
  178.         import pwd as pwd
  179.         os.environ['HOME'] = pwd.getpwuid(os.getuid())[5]
  180.     
  181.     if not os.environ.has_key('PLAT'):
  182.         os.environ['PLAT'] = get_platform()
  183.     
  184.     _environ_checked = 1
  185.  
  186.  
  187. def subst_vars(s, local_vars):
  188.     """Perform shell/Perl-style variable substitution on 'string'.  Every
  189.     occurrence of '$' followed by a name is considered a variable, and
  190.     variable is substituted by the value found in the 'local_vars'
  191.     dictionary, or in 'os.environ' if it's not in 'local_vars'.
  192.     'os.environ' is first checked/augmented to guarantee that it contains
  193.     certain values: see 'check_environ()'.  Raise ValueError for any
  194.     variables not found in either 'local_vars' or 'os.environ'.
  195.     """
  196.     check_environ()
  197.     
  198.     def _subst(match, local_vars = local_vars):
  199.         var_name = match.group(1)
  200.         if local_vars.has_key(var_name):
  201.             return str(local_vars[var_name])
  202.         else:
  203.             return os.environ[var_name]
  204.  
  205.     
  206.     try:
  207.         return re.sub('\\$([a-zA-Z_][a-zA-Z_0-9]*)', _subst, s)
  208.     except KeyError:
  209.         var = None
  210.         raise ValueError, "invalid variable '$%s'" % var
  211.  
  212.  
  213.  
  214. def grok_environment_error(exc, prefix = 'error: '):
  215.     """Generate a useful error message from an EnvironmentError (IOError or
  216.     OSError) exception object.  Handles Python 1.5.1 and 1.5.2 styles, and
  217.     does what it can to deal with exception objects that don't have a
  218.     filename (which happens when the error is due to a two-file operation,
  219.     such as 'rename()' or 'link()'.  Returns the error message as a string
  220.     prefixed with 'prefix'.
  221.     """
  222.     if hasattr(exc, 'filename') and hasattr(exc, 'strerror'):
  223.         if exc.filename:
  224.             error = prefix + '%s: %s' % (exc.filename, exc.strerror)
  225.         else:
  226.             error = prefix + '%s' % exc.strerror
  227.     else:
  228.         error = prefix + str(exc[-1])
  229.     return error
  230.  
  231. _wordchars_re = None
  232. _squote_re = None
  233. _dquote_re = None
  234.  
  235. def _init_regex():
  236.     global _wordchars_re, _squote_re, _dquote_re
  237.     _wordchars_re = re.compile('[^\\\\\\\'\\"%s ]*' % string.whitespace)
  238.     _squote_re = re.compile("'(?:[^'\\\\]|\\\\.)*'")
  239.     _dquote_re = re.compile('"(?:[^"\\\\]|\\\\.)*"')
  240.  
  241.  
  242. def split_quoted(s):
  243.     '''Split a string up according to Unix shell-like rules for quotes and
  244.     backslashes.  In short: words are delimited by spaces, as long as those
  245.     spaces are not escaped by a backslash, or inside a quoted string.
  246.     Single and double quotes are equivalent, and the quote characters can
  247.     be backslash-escaped.  The backslash is stripped from any two-character
  248.     escape sequence, leaving only the escaped character.  The quote
  249.     characters are stripped from any quoted string.  Returns a list of
  250.     words.
  251.     '''
  252.     if _wordchars_re is None:
  253.         _init_regex()
  254.     
  255.     s = string.strip(s)
  256.     words = []
  257.     pos = 0
  258.     while s:
  259.         m = _wordchars_re.match(s, pos)
  260.         end = m.end()
  261.         if end == len(s):
  262.             words.append(s[:end])
  263.             break
  264.         
  265.         if s[end] in string.whitespace:
  266.             words.append(s[:end])
  267.             s = string.lstrip(s[end:])
  268.             pos = 0
  269.         elif s[end] == '\\':
  270.             s = s[:end] + s[end + 1:]
  271.             pos = end + 1
  272.         elif s[end] == "'":
  273.             m = _squote_re.match(s, end)
  274.         elif s[end] == '"':
  275.             m = _dquote_re.match(s, end)
  276.         else:
  277.             raise RuntimeError, "this can't happen (bad char '%c')" % s[end]
  278.         if m is None:
  279.             raise ValueError, 'bad string (mismatched %s quotes?)' % s[end]
  280.         
  281.         (beg, end) = m.span()
  282.         s = s[:beg] + s[beg + 1:end - 1] + s[end:]
  283.         pos = m.end() - 2
  284.         if pos >= len(s):
  285.             words.append(s)
  286.             break
  287.             continue
  288.     return words
  289.  
  290.  
  291. def execute(func, args, msg = None, verbose = 0, dry_run = 0):
  292.     '''Perform some action that affects the outside world (eg.  by
  293.     writing to the filesystem).  Such actions are special because they
  294.     are disabled by the \'dry_run\' flag.  This method takes care of all
  295.     that bureaucracy for you; all you have to do is supply the
  296.     function to call and an argument tuple for it (to embody the
  297.     "external action" being performed), and an optional message to
  298.     print.
  299.     '''
  300.     if msg is None:
  301.         msg = '%s%r' % (func.__name__, args)
  302.         if msg[-2:] == ',)':
  303.             msg = msg[0:-2] + ')'
  304.         
  305.     
  306.     log.info(msg)
  307.     if not dry_run:
  308.         apply(func, args)
  309.     
  310.  
  311.  
  312. def strtobool(val):
  313.     """Convert a string representation of truth to true (1) or false (0).
  314.  
  315.     True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
  316.     are 'n', 'no', 'f', 'false', 'off', and '0'.  Raises ValueError if
  317.     'val' is anything else.
  318.     """
  319.     val = string.lower(val)
  320.     if val in ('y', 'yes', 't', 'true', 'on', '1'):
  321.         return 1
  322.     elif val in ('n', 'no', 'f', 'false', 'off', '0'):
  323.         return 0
  324.     else:
  325.         raise ValueError, 'invalid truth value %r' % (val,)
  326.  
  327.  
  328. def byte_compile(py_files, optimize = 0, force = 0, prefix = None, base_dir = None, verbose = 1, dry_run = 0, direct = None):
  329.     '''Byte-compile a collection of Python source files to either .pyc
  330.     or .pyo files in the same directory.  \'py_files\' is a list of files
  331.     to compile; any files that don\'t end in ".py" are silently skipped.
  332.     \'optimize\' must be one of the following:
  333.       0 - don\'t optimize (generate .pyc)
  334.       1 - normal optimization (like "python -O")
  335.       2 - extra optimization (like "python -OO")
  336.     If \'force\' is true, all files are recompiled regardless of
  337.     timestamps.
  338.  
  339.     The source filename encoded in each bytecode file defaults to the
  340.     filenames listed in \'py_files\'; you can modify these with \'prefix\' and
  341.     \'basedir\'.  \'prefix\' is a string that will be stripped off of each
  342.     source filename, and \'base_dir\' is a directory name that will be
  343.     prepended (after \'prefix\' is stripped).  You can supply either or both
  344.     (or neither) of \'prefix\' and \'base_dir\', as you wish.
  345.  
  346.     If \'dry_run\' is true, doesn\'t actually do anything that would
  347.     affect the filesystem.
  348.  
  349.     Byte-compilation is either done directly in this interpreter process
  350.     with the standard py_compile module, or indirectly by writing a
  351.     temporary script and executing it.  Normally, you should let
  352.     \'byte_compile()\' figure out to use direct compilation or not (see
  353.     the source for details).  The \'direct\' flag is used by the script
  354.     generated in indirect mode; unless you know what you\'re doing, leave
  355.     it set to None.
  356.     '''
  357.     if direct is None:
  358.         if __debug__:
  359.             pass
  360.         direct = optimize == 0
  361.     
  362.     if not direct:
  363.         
  364.         try:
  365.             mkstemp = mkstemp
  366.             import tempfile
  367.             (script_fd, script_name) = mkstemp('.py')
  368.         except ImportError:
  369.             mktemp = mktemp
  370.             import tempfile
  371.             script_fd = None
  372.             script_name = mktemp('.py')
  373.  
  374.         log.info("writing byte-compilation script '%s'", script_name)
  375.         if not dry_run:
  376.             if script_fd is not None:
  377.                 script = os.fdopen(script_fd, 'w')
  378.             else:
  379.                 script = open(script_name, 'w')
  380.             script.write('from distutils.util import byte_compile\nfiles = [\n')
  381.             script.write(string.join(map(repr, py_files), ',\n') + ']\n')
  382.             script.write('\nbyte_compile(files, optimize=%r, force=%r,\n             prefix=%r, base_dir=%r,\n             verbose=%r, dry_run=0,\n             direct=1)\n' % (optimize, force, prefix, base_dir, verbose))
  383.             script.close()
  384.         
  385.         cmd = [
  386.             sys.executable,
  387.             script_name]
  388.         if optimize == 1:
  389.             cmd.insert(1, '-O')
  390.         elif optimize == 2:
  391.             cmd.insert(1, '-OO')
  392.         
  393.         spawn(cmd, dry_run = dry_run)
  394.         execute(os.remove, (script_name,), 'removing %s' % script_name, dry_run = dry_run)
  395.     else:
  396.         compile = compile
  397.         import py_compile
  398.         for file in py_files:
  399.             if file[-3:] != '.py':
  400.                 continue
  401.             
  402.             if not __debug__ or 'c':
  403.                 pass
  404.             cfile = file + 'o'
  405.             dfile = file
  406.             if prefix:
  407.                 if file[:len(prefix)] != prefix:
  408.                     raise ValueError, "invalid prefix: filename %r doesn't start with %r" % (file, prefix)
  409.                 
  410.                 dfile = dfile[len(prefix):]
  411.             
  412.             if base_dir:
  413.                 dfile = os.path.join(base_dir, dfile)
  414.             
  415.             cfile_base = os.path.basename(cfile)
  416.             if direct:
  417.                 if force or newer(file, cfile):
  418.                     log.info('byte-compiling %s to %s', file, cfile_base)
  419.                     if not dry_run:
  420.                         compile(file, cfile, dfile)
  421.                     
  422.                 else:
  423.                     log.debug('skipping byte-compilation of %s to %s', file, cfile_base)
  424.             newer(file, cfile)
  425.         
  426.  
  427.  
  428. def rfc822_escape(header):
  429.     '''Return a version of the string escaped for inclusion in an
  430.     RFC-822 header, by ensuring there are 8 spaces space after each newline.
  431.     '''
  432.     lines = string.split(header, '\n')
  433.     lines = map(string.strip, lines)
  434.     header = string.join(lines, '\n' + '        ')
  435.     return header
  436.  
  437.